Full Specfication for: Zoner's Half-Life Compilation Tools 2.5.3, Custom Build 1.6
Revised 10/05/`02 Anthony Moore
Generally, only Fatal errors are written to the mapname.err file. The presence of this file will stop the complation of hlbsp, hlvis and hlrad.
Note; that this error table is only applicable to Custom Build 1.6. The normal ZHLT differs slightly from this table.
| Error | Description | HowToFix |
| invalid assume message | This is a message should never be printed. | contact merlinis@bigpond.net.au concerning this issue. |
| Memory allocation failure | The program failled to allocate a block of memory. | Likely causes are (in order of likeliness) : the partition holding the swapfile is full; swapfile size is smaller than required; memory fragmentation; heap corruption |
| NULL Pointer | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Bad Thread Workcount | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Unable to create thread | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_PLANES | The maximum number of plane definitions has been reached | The map has grown too complex |
| Exceeded MAX_MAP_TEXTURES | The maximum number of textures for a map has been reached | selfexplanitory |
| Exceeded MAX_MAP_MIPTEX | Texture memory usage on the map has exceeded the limit | Merge similar textures, remove unused textures from the map |
| Exceeded MAX_MAP_TEXINFO | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_SIDES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_BRUSHES | The maximum number of brushes for a map has been reached | selfexplanitory |
| Exceeded MAX_MAP_ENTITIES | The maximum number of entities for the compile tools has been reached | selfexplanitory |
| Exceeded MAX_ENGINE_ENTITIES | The maximum number of entities for the half-life engine has been reached | selfexplanitory |
| Exceeded MAX_MAP_MODELS | The maximum number of brush based entities has been reached | Remove unnecessary brush entities, consolidate similar entities into a single entity |
| Exceeded MAX_MAP_VERTS | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_EDGES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_CLIPNODES | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Exceeded MAX_MAP_MARKSURFACES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_FACES | The maximum number of faces for a map has been reached | This error is typically caused by having a large face with a small texture scale on it, or overly complex maps. |
| Exceeded MAX_MAP_SURFEDGES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_MAP_NODES | The maximum number of nodes for a map has been reached | The map is too complex for the game engine/compile tools to handle. Simplify |
| CompressVis Overflow | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| DecompressVis Overflow | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Execution Cancelled | Tool execution was cancelled either by the user or due to a fatal compile setting | selfexplanitory |
| Internal Error | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Error | Description | HowToFix |
| Missing '[' in texturedef (U) | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| plane with no normal | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| brush with coplanar faces | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| brush outside world | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| mixed face contents | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Brush type not allowed in world | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Brush type not allowed in entity | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| No visibile brushes | All brushes are CLIP or ORIGIN (at least one must be normal/visible) | selfexplanitory |
| Entity with ONLY an ORIGIN brush | All entities need at least one visible brush to function properly. CLIP, HINT, ORIGIN, do not count as visible brushes. | selfexplanitory |
| Could not find WAD file | The compile tools could not locate a wad file that the map was referencing. | Make sure the wad's listed in the level editor actually all exist |
| Exceeded MAX_TRIANGLES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SWITCHED_LIGHTS | The maximum number of switchable light entities has been reached | selfexplanitory |
| Exceeded MAX_TEXFILES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Error | Description | HowToFix |
| LEAK in the map | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Exceeded MAX_LEAF_FACES | This error is almost always caused by an invalid brush, by having huge rooms, or scaling a texture down to extremely small values (between -1 and 1) | Find the invalid brush. Any imported prefabs, carved brushes, or vertex manipulated brushes should be suspect |
| Exceeded MAX_WEDGES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_WVERTS | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SUPERFACEEDGES | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |
| Empty Solid Entity | A solid entity in the map (func_wall for example) has no brushes. | If using Worldcraft, do a check for problems and fix any occurences of 'Empty solid' |
| Error | Description | HowToFix |
| Leaf portal saw into leaf | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Exceeded MAX_PORTALS_ON_LEAF | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Invalid client/server state | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Error | Description | HowToFix |
| Exceeded MAX_TEXLIGHTS | The maximum number of texture lights in use by a single map has been reached | Use fewer texture lights. |
| Exceeded MAX_PATCHES | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Transfer < 0 | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Bad Surface Extents | The map has a problem which must be fixed | Check the file ZHLTProblems.html for a detailed explanation of this problem |
| Malformed face normal | The texture alignment of a visible face is unusable | If using Worldcraft, do a check for problems and fix any occurences of 'Texture axis perpindicular to face' |
| No Lights! | lighting of map halted (I assume you do not want a pitch black map!) | Put some lights in the map. |
| Bad Light Type | The compiler tool had an internal error | contact merlinis@bigpond.net.au concerning this issue. |
| Exceeded MAX_SINGLEMAP | The compiler tool hit an internal limit | contact merlinis@bigpond.net.au concerning this issue. |